Parameters Required in Requests to Import Existing Microsoft Active Subscriptions

To import active Microsoft subscriptions to CloudBlue Connect, it is necessary to complete the following steps:

1. When placing an order, the migration_info_object parameter must contain the subscription id, customer id, csp order id and the Microsoft domain of the subscription to be imported. This information must be provided in JSON format. For example:

   Note:
   - The customer id, subscription id, csp order and Microsoft domain (.onmicrosoft.com) are mandatory.
   - Refer to CloudBlue Commerce API documentation for additional information on how to manage orders through the platform's API.

   Copy

   {
          {
           "key": "migration_info_object",
           "structured_value":
           {
               "ms_customer_id": "value of the param 1",
               "subscription_id": "value of the param 2",
               "csp_order_id": "value of the param 3"
           }
       },
       {
           "key": "microsoft_domain",
           "value": "DevDomain.onmicrosoft.com"
       }
   }

2. When a new order is placed, the processor will check if the migration_info_object parameter contains data. If that is the case, the order will be considered as an import and the processor will use the information provided in the such parameter to populate the corresponding fulfillment parameters.

Note: The provided customer id, subscription id and order id, as well as other attributes such as the SKU id, quantity, billing frequency and billing terms will be validated to ensure that the data in the order matches the information in the existing Microsoft subscription to be imported. If the validation is not successful the order will be failed.

Important:
- It is only possible to migrate active Microsoft subscriptions.
- The import of trial subscriptions is not supported.
- In the case that the offer does not have a subscription ID (Perpetual), the order ID must be included in both the subscription_id and csp_order_id properties.

Parameter ID	Required	Description
migration_info_object	Yes	JSON structure with the following parameters: Parameter ID Description ms_customer_id The Microsoft customer Id of the subscription to be imported. subscription_id The Microsoft subscription Id of the subscription to be imported. csp_order_id The Microsoft order Id of the subscription to be imported.
microsoft_domain	No	The Microsoft domain of the subscription to be imported including ".onmicrosoft.com". For example: mycompanyDomain.onmicrosoft.com.